Document your crate's feature flags
This crate provides a macro that extracts documentation comments from Cargo.toml
To use this crate, add #![doc = document_features::document_features!()]
in your crate documentation.
The document_features!()
macro reads your Cargo.toml
file, extracts feature comments and generates
a markdown string for your documentation.
Use ##
and #!
comments in your Cargo.toml to document features, for example:
[]
= "0.2"
## ...
[]
## The foo feature enables the `foo` functions
= []
## The bar feature enables the [`bar`] module
= []
#! ### Experimental features
#! The following features are experimental
## Activate the fusion reactor
= []
These comments keep the feature definition and documentation next to each other, and they are then rendered into your crate documentation.
Check out the documentation for more details.
Contributions
Contributions are welcome. We accept pull requests and bug reports.
License
MIT OR Apache-2.0